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ABSTRACT 



Two or more interconnected computer systems, each having 
a different operating system. For example, a client system 
may be running the OS/2 operating system and a second, 
server computer the ADC system. The server system mat 
allocates display screen space for application windows run- 
ning on the server system and supports window manage- 
ment Further, the window management places GUI borders 
around the application window which allow a user to 
interact with the client application. The functions in these 
GUI borders include a menu bar, scroll bar, sizing features, 
pull down windows, and the like. The client application is 
mapped into a form which enables the application com- 
mands to be recognized by a library of functional calls 
associated with the server system. The server system, dis- 
plays the client application in the designated window along 
with the server GUI In mis manner a user can interact with 
a client application using the server graphical user interface. 

14 Claims, 6 Drawing Sheets 
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METHOD AND SYSTEM FOR DISPLAYING SUMMARY OF THE INVENTION 

APPLICATIONS OF DIFFERENT . , ^ , ^ . 

OPERATING SYSTEMS ON A SINGLE b (>esiraUe to nave we ability to use the GUI that is most 

SYSTEM USING THE USER INTERFACE OF familiar to a user, even when running an application program 

THE DIFFERENT OPERATING SYSTEMS 5 operates in conjunction with an unfamiliar operating 

RAPKraniTNTi OF tttr TNVPNTinu systcm ' ^ GUL For example, an ADC user will appreciate 

BACKGROUND OF THE INVENTION being able to run an application written for OS/2 within a 

1. Field of the Invention window in conjunction with the ADC graphical user inter- 
The present invention generally relates to the display of face* In this manner a distributed system is created wherein 

an application on the screen of a remote computer system. 1Q applications running on a first system are used remotely. 
More particularly, a program application that runs on a first Broadly, the present invention includes at least two inter- 
operating system is capable of being displayed on the screen connected computer systems, each having a different oper- 
of a computer system using a second different operating ating system running thereon. For example, a first system 
system such that the graphical user interface (GUI) of the may be running the OS/2 system and a second computer the 
second operating system is used to present the program 15 ADC system The X Window System (X) is a display 
application of the first operating system. environment, or graphical user interface that is available 

2. Description of Related Art from MTT (X Window System is a trademark of the Mas- 
Currently it is known for an operating system window sachusetts Institute of Technology) and runs on the operating 

manager to allocate a portion of a display screen that can be systems, such as the UNIX system, ADC operating system, 

used by an operating system. In particular, U.S. Pat No. 20 ^ other systems based on the UNIX OS. This GUI 

4,937,036, 4,937,507 and 4,920,481 describe systems includes a server (X server) that allocates display screen 

wherein a portion of the display screen is allocated for use space for applications running on the ADC system. Further, 

by a processor which emulates another processor in this the window manager places GUI borders in the window 

window. This window will include the user interface for the which allow a user to interact with the application running 

emulated operating system. 25 me *ein. The functions in these GUI borders include a menu 

U.S. Pat No. 4,961,133 discusses a system for providing bar, title bar, scroll bar, sizing features, pull down windows, 

portability of program applications across different hard- and the like. The present invention allows a non-ADC 

ware and operating system environments. The transportable application (such as an OS/2 application), a non X Window 

code is compiled and linked to create code executable by application, or the like, to run within the window allocated 

another operating system. U.S. Pat No. 4,&55,936 is an 30 bv ADC window manager and in conjunction with the 

application pr o gram interface that handles full screen input/ ADC (Xll) GUI border contained therein, 

output (I/O) display operations. The application program is First, the non-ADC application calls are mapped into an 

required to determine display characteristics prior to per- Xll form which enables the application commands to be 

forming full screen I/O operations and provide a buffer as recognized by the X library of functional calls. The operat- 

output is to be performed. The application programming 35 ing system, for which this application was written, e.g. OS/2, 

interface provides a means for allowing an application must be compatible with the X library (X lib). The operating 

programmer to write an application without being concerned system then sends the translated OS/2 application instruc- 

with the low level detail of full screen I/O operations. That tions to, for example, the ADC operating system through the 

is, the application is architecture independent with respect to TCP/IP cornmunicarions protocol. The Xll server, working 

the full screen I/O operations. Japanese patent JP 58-31438 40 in conjunction with the X window manager displays (he 

is a system that converts messages into specific display OS/2 application in the designated window along with the 

format suitable for centralized monitoring and control A ADC GUI In this manner the output of an OS/2 application 

protocol converting portion transforms a message into a will be displayed in conjunction with the ADC graphical user 

specific format, as required. The central monitoring system interface. Further, the process is reversed and input from the 

established an interface for tra nsmirring/recelving the pro- 45 user, to the ADC GUI, are mapped into OS/2 application calls 

tocoL such that the OS/2 application can be manipulated by input 

It can be seen that the related art merely allows for a host to the ADC GUI. 

system to allocate a specific portion of its display to a client Therefore, in accordance with the previous summary, 

operating system, which is either emulated from the host object, features and advantages of the present invention will 

processor, or remotely connected. However, each of the 50 become apparent to one skilled in the art from the subse- 

described references require a client operating system win- quent description and the appended claims taken in con- 

dow. Further, if the client operating system supports win- junction with the accompanying drawings, 
dowed applications, such application windows are confined 

to the client OS window. None of the described references BRIEF DESCRIPTION OF THE DRAWINGS 

can display a client OS application window directly on the 55 , . £ _ - . 

host OS window without the need for a client OS window. mG 1 is a scheir^c representation of a typical data 

A need exists for a system wherein multiple application P ^T g 5yStCm ^ ^ * C ** cscnt invcatl0D ^ te 

windows from multiple client operating systems can be run utulzc <*» 

as peers with host application windows in a host operating 2 * a olock diagram showing the specific compo- 
system window. However, none of the described references 60 ncots of f system using the present invention and then- 
show a first system, which uses its own window manager to relationship with one another 

display the first operating system GUI in a window, tunning FIG. 3 is a display screen of a computer system fllustrat- 

a program application written for an entirely different oper- ing another embodiment of the present invention wherein a 

ating system, concurrently in the same window with the first remote application is running in the same window with the 

operating system GUL Thus, it can be seen that a need exists 65 GUI of a system using a different operating system; 

for a system wherein multiple graphical user interfaces can FIG. 4 is a display screen of a computer system ilhtstrat- 

be run concurrently in a single window. ing a first embodiment of the present invention wherein a 
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remote application and its GUI are running on a system with Generally, window systems (Le GUI) are tied to a spedfic 
a differed operating system; operating system, e.g. PM and OS/2. Therefore, the torn 

function of the present invention which allows a program across operating system plat- 

application to be interactively running in a window of a 5 h^T^aOn7^8tem on which 

display on a ^ Z**^™ ° P ™* g X^wH^ 

system wherein multiple GUI s are present System. Tie X Windows interface includes a 

DETAILED DESCRIPTION OF THE library of function calls, known as the X library. This library 

PREFERRED EMBODIMENTS |Q includes commands that will control various display 

Referring to FIG. 1, a typical data processing system is functions, such as input/output control of the display, 
shown which may be used in conjunction with the present keyboard, mouse, and the like. This library is essentially a 
invention. A central processing unit (CPU), such as one of collection of routines that can be used to create an X client 
me fotel X86 processors or an IBM reduced instruction set program application. Thus, due to the mapping of the PM 
computing (RISC) processors, is provided and intercom 15 calls into X lib calls, the OS/2 application 3 essentially 
nected to the various other components by system bus 12. becomes an X client application. Operating system 9 is 
Read only memory (ROM) 16 is connected to CPU 10 via shown as the OS/2 system from IBM, Corp. and provides all 
bus 12 and includes the basic input/output system (BIOS) of the low level control and data management functions 
that controls the basic computer functions. Random access required to implement appUcation programs on specific 
memory (RAM) 14 I/O adapter 18 and communications 20 hardware platforms, such as the PS/2 computer system, 
adapter 34 are also interconnected to system bus IX I/O commercially available from IBM Corporation (PS/2 is a 
adapter 18 may be a small crcnputer system interface (SCSI) trademark of IBM Corp.). The operating system 9 then 
adapter that communicates with a disk storage device 20. comnuimcates with a remote operating system lW^g- 
Communications adapter 34 interconnects bus 12 with an ADC) by way of a rornmunications protocol, such as TCP/TP, 
outside network enabling the date processing system to 35 or the like. In this manner the two different mconmatible 
cornmunicate with other such systems. Input/Output devices operating systems, e.g. OS/2 and ATX can coninuinicate 
are also comiccted to system bus 12 via user interface with one another. 

adapter 22 and display adapter 36. Keyboard 24, track ball The X server component 103 is running on the ADC 
32. mouse 26 and speaker 28 arc aU mtcrconnected to bus 12 system and provides screen management facilities for dis- 
via user interface adapter 22. Display monitor 38 is con- 30 play 107. More particularly, the X server is a graphics driver 
nected to system bus 12 by display adapter 36. In this that controls the system. It handles requests from an X client 
manner, a user is capable of inputting to the system through application to created windows, draw lines, circles, text, and 
the keyboard 24, track ball 32 or mouse 26 and receiving the like on the computer system display screen. Further, the 
output from the system via speaker 28 and display 38. X server will handle keyboard and mouse input from the 
Additionally, the operating system such as DOS, ADC or the 35 computer system and relays this information back to the X 
OS/2 system (ADC and OS/2 are Trademarks of IBM client A window manager 105 is also part of the X Windows 
Corporation) is used to coordinate the functions of the interface and is used to allocate screen resources between 
various components shown in FIG. 1. The computer system various program applications, am well as, operating system 
shown in FIG. 1 is an example of the type of systems mat functions that require information to be displayed. The 
are capable of utilizing the present invention and can be used 40 window manager is a special X client that is run (one for 
as die host or remote system each X server) in order to supervise the control of windows 

FIG 2 is a block diagram showing the various compo- created on the display. The window manager creates the 
nents of an interconnected system utilizing the present "look and feeT of the user interface. Further, the window 
invention. A client system is generally noted by reference manager is responsible for placing any border around the 
numeral 1 A client program appUcation 3 is shown, which 45 window, such as a tide bar, control buttons to maximize or 
is a program written specifically for a particular operating minimize the window, scroll buttons, system menu, or the 
system. In this case the client appUcation, is written for the like. The window manager also handles user input requiring 
OS/2 operating system. Further, the Presentation Manager movement or resizing of the window. In a preferred embodi- 
11 is provided which is a programming interface used in ment of the present invention, the Motif window manager 
conjunction with the OS/2 system. The purpose of PM is to 30 from the Open Software Foundation (OSF) is conternplated 
provide a consistent application program interface for appli- for use as window manager 105. It should be noted that those 
cation written to OS/2. Specifically, FM provides Gpi and of skill in this art will be famfliar with the operation of the 
Win API support for the OS/2 applications. That is, PM X Window System components. Therefore, the function of 
provides all of the graphics support (Gpi) and window these components will not be further discussed, 
management (WIN API) for the program applications. 55 FIG. 3 is a screen on display 107 showing a typical X 

In order for the present invention to function, the calls Windows display workplace wherein various ADC system 
from the FM 11 must be mapped into a form that is program applications are running. For example a clock 
recognizable by the operating system running on the inter- program 109 is shown along with an ADC appUcation 
connected system. FcTcxample, the Xll graphical user running in an X Window 113. The ADC application may be 
interface is commonly used in conjunction with systems 60 a word processiiig/desktop pubushing application, such as 
based on the UNIX operating system (UNIX is a trademark Interleaf, ADC Interface Composer, or the like. Of course, 
of Unix Systems Laboratories, Inc.), such as the ADC sys- many other program appUcations are capable of being run in 
tera Thus a mapping inechanism 5 is provided which will window 113. A graphical user interface 111 is shown around 
transform the appUcation calls into a form mat is recogniz- the circumference of window 113. This is part of the X GUI 
able by the interconnected operating system. This mapping 65 and includes I/O features such as, software buttons, a scroll 
function will be described in more detail in conjunction with bar, pull down menus, a title bar 119, icons 121. and the like. 
PIGS 5A through 5C described below. Another window 117 is shown on display 107 which is an 
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OS/2 system program application, such as Lotus 1-2-3, There arc two types of window GUI's that can be used, as 
Excel, Clock, or the like running therein. Additionally, an X illustrated by FIGS. 3 and 4. FIG. 3 shows a system where 
system GUI border 115 is present around the periphery of there is not subclassing. This means that DPM will make no 

window 117. GUI US includes all of the J/O components change to the default setting and the local window manager 

normally found in an X border, which includes the scroll bar, 5 will be in control This is the preferred ernbodiment and will 
icons, and the like, previously mentioned. In this manner, a Include an X Window System having a GUI border that 
user is capable of running a program application written for includes the title bar, scroll bar. software buttons, window 
a first specific operating system (e.g. OS/2) on a platform sizing icons, and the like associated with a standard X GUL 

having a second different operating system (eg. AIX) such A subclassed GUI means mat the DPM GUI will be dis- 

that the program application written for the first operating 10 played either in conjunction with the X GUI or written on 

system responds to the user inputs to GUI associated with top of the X GUI such that only the DPM border is visible, 

toe second operating system. Further, the program applica- At step 3, the PM to X mapping layer 5 is used to translate 

tion win provide output to the user in accordance with the the PM calls to X recognizable commands. A translate table 

GUI from the second operating system. For example, the is used to accomplish mis conversion. Several problems had 

program application may provide different titles to the 13 to be overcome in order to make this conversion For 

window manager 105 for display on the tide bar, and the example, the X window manager normally, initializes a 

scroll bar on the GUI border will change as the user scrolls window and then instructs the X client application that it has 

through a document in a word processing application. Thus, permission to write to the window. In contrast the PM 

toe program application must provide output to the GUI in interface is used to opening a window and then immediately 

order for it to display the proper position of the scroll bar. It ^ drawing to it The PM method contemplates local, not 

can be seen that not only does toe present invention provide networked systems. Thus, a conversion had to be made that 

a system that allows a user to run program applications would cause the PM interface to wait for some period of 

written for a different operating system, but also allows the time before drawing to toe X window. Further, a mapping 

user to interact with toe application through a graphical user relationship was created between the PM and X systems so 

interface, based on the operating system resident on their 25 that the X Window handles could be recognized and 

system. Thus, a user can run applications written for differ- manipulated by the application 3 running on the remote 

ent systems, and still be able to interact with these new system. The window manager will also recognize input from 

applications through a familiar graphical user interface. the DPM (via the X lib and X server) that will allow the titles 

FIG. 4 is a screen of display 107 illustrating another on the GUI title bar to be changed. For example, if the X 

embodiment of the present invention. More particularly, the 30 GUI tide bar includes File, Edit, Help and Options, but the 

same ADC applications 169, 111, 113 are shown running on DPM program application also includes the title of Tools, 

toe display, along with a distributed PM application 117 then the DPM command can be translated and sent to the X 

running in a window having DPM border 115. In this case, window manager in order to make the title bar consistent 

toe DPM GUI is displayed on top of the ADC border, such with the program application ru nnin g on OS/2, 

that the user sees only the DPM GUL Additionally, it is 35 Subsequent to step 3, the window has been created on the 

possible to "shadow" the ADC border with the DPM border display 107 and it is then determined if the distributed PM 

such that both are visible. In most cases both sets of application needs to draw lines (step 4\ If so, the process 

functions will work and toe user can use the GUI which is continues to step 5 where the line coordinates are translated 

most familiar. by the PM to X mapping means 5. It should be noted that 

Referring to the flow charts of FIGS. 5A-5C, the opera- 40 line drawing is a fairly straight forward process, ie. begin- 

tion of toe present invention will now be described. It should ning and ending points are identified and and the intexme- 

be noted that FIGS. 5A-5C are representative of the opera- diate pixels must be painted. In the X system, toe initial pixel 

tions that the present invention will perform in order to 0,0 is at the upper right portion of the screen and with PM 

display a client application in a window of a host system. it is at toe lower right corner. Therefore, the y coordinates of 

There are innumerable combinations of PM outputs that 45 the pixels must be translated. Once the translation is 

must be mapped to X lib calls. Thus, FIGS. 5A-5C show the complete, the call is made (step 6) from the PM interface 11 

basic functions of line drawing, curve drawing and text to toe X lib 7, which then outputs the equivalent X com- 

mapping. Those skilled in the ait will understand how to mands that will cause the line to be drawn. The line is then 

apply these basic mapping operations to other functions drawn into the window at step 7, and the operation jumps to 

output from toe client application. 50 step 17. 

At step 1 the remote, or client application is initiated. One If it is determined that there is 00 line to be drawn at step 

way is for the host, or server system user to input a 4, the operation proceeds to step 8 which determines if text 

startup.cmd and syslogin.cmd commands. This method will is to be written into the window. If so, the DPM text 

resemble remote startup using the RSH daemon on TCP/IP. characters are translated by the mapping means 5 and input 
For example, the ADC user will issue the command: rsh 55 to X lib 7 (step 9). Both PM and X use ASCII characters so 

SNOD^start/d^mx^DISPLAYmyijar^^ this translation is relatively simple. However, these two 

will cause the DPM daemon on remote node $NODE to systems do not necessarily use interchangeable fonts, 

prompt for a usemame and password. If the user name and Therefore, at step 10, the mapping means compares the PM 

password are valid toe process is then started. At step Z, the fonts to toe closest predetermined X fonts and outputs the 
application calls the Wlnlnitialize command which checks 60 command for these X fonts to the X lib. At step 11, the 

for the distributed PM environment If the DPM exists, a translated text is presented in the displayed in window 117 

specific dynamic linked library is called that wfll build a of FIG. 3. Subsequent to step 11 the method proceeds to step 

table of subroutine addresses that will convert toe calls to X 17. If, at step 8 there is no text to be drawn, then the method 

library recognizable commands. This dynamic linked library proceeds to step 12 which determines if a curve, such as a 
(DLL) is provided in toe PM interface application. Further, 65 spline, is to be displayed. If so, the PM interface outputs the 

the calls from the application to the WIN and Gpi APIs in the beginning and ending points of the curve to the mapping 

PM interface are captured and redirected to the X library. means (step 13). In many cases, the X lib will not include 
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function that corresponds to the function desired by the an X structure, as in the case of a PM window handle being 

program application. Curves are one example of this type of mapped to an X window handle/display combination), 

function. Therefore, it was determined mat support needed ft should be understood that the above description of 

to be provided for a spline, which is a type of curve. In mis various translations are provided as examples and should not 

case, the PM interface provides the coordinates for the s ^ considered as all of the types of translatfens that must be 

endpoints to the mapping means. Further, the PM interface performed by the mapping means. The present Invention 

will indicate that a spline is to be drawn. Since, there is no ^ &aphica[ or windowed program applications run on 

equivalent function in the X lib, the mapping means then a fot to be displayed and interacted with through a 

provides this new functionality by calling a subroutine (step ^ numiQg on a different operating system. 

14} which determines which pixels intermediate the end- ir > A ^ . ^ , . _ 

£t£ Z£%££fiS£Z£ functions include HE font support wind^ 

pSC « detained, cdls arc mack r a st^dard line draw m ^«? ent ^ 0r ""^ <»* ^"f V ^ 

SI Se^7 for these pixels. The X lib then outputs 15 cursor) line draw^,^ towtag^ M n*egv ,tataap 

r— — . . ~T l 15 conversions, and the Kke. It has been shown mat some of 

commands which will cause the appiopnate puels to be relatively simple (e.g. line drawing and 

tainted. It can be seen that a vutuatty unlimited amount of m « j °""»~ , .. 

n^fanctir may have to be supported in the mapping ««» mapmng) while others are extremely comphcated (eg 
new runcooD may « «v i. ^wLiu curve drawing). As a representative example of how one of 

*XS££SSZ Sf»TZ^« *e more raSplex functions can beeped between the 
being addedto new ^l^ons be^w^iL At s^ 1^ M S Q ^ me ^ wi*,^^ the fol- 

the output from the X lib, that represents me curve is . . . „^ . 

providedto the X server so the curve can be drawn in the lowm * <^cription 15 Prided. 

window (step 16). BITMAP FUNCTION MAPPING 

If at step 12 it was determined that no curves were to be 

displayed the operation skips to step 22 which deterniines if M The Bitmap component of PPM is concerned with all 

there are any other application output requests to be pro- functionality related to displaying, modifying, and querying 

cessed. If so, step 23 maps the output from PM into an X bitmaps. Only bitmaps that have been created explicitly (Le. 

call. Step 24 then mates the call to the X lib and the display that have a specific HBITMAP handle) are ever eligible to 

is output on the window at step 25. If there are no other reside on the server. Since bitmaps created in other ways 

application output requests, then the process moves directly 30 either cannot be monitored or are transient, there is little 

from step 22 to stop 17. performance lost in sending these to the server each time. 

At step 17 it is determined if the host system user (AJX) The server has a limited capability for storing bitmaps 

will interact with the remote application (OS/2) by entering (pixmaps). If the server cannot store a bitmap, men previous 

input If not, the process continues to step 26. If the bitmaps are removed in a least-recently-used order. Locally, 

application does allow for user interaction, at step 18, an 35 these bitmaps are marked to indicate this fact 

identifier is returned to the X server 113. This identifier will apt twtatt 5 

be in the form of a number mat corresponds to keystrokes, AW tusl AAA ^* 

^&S£X^tSg^^ NAMB DESGRlm0N ° F 

system input into a letter that is recognizable by the DPM 40 OpiBitBlt 

system. A translate table is used to make this conversion This function moves bit arrays between two presentation 

which takes into account certain predetermined conditions. spaces, both of which may be the same. Alternatively, only 

For example, the X system allows for one finger keyboard one presentation space can be provided. In mis case, the 

operation wherein a user can press shift and subsequently blitting operation will involve only the manipulation of 

press, eg. "IT, and the result will be identical to pressing 45 agnation bit data and possibly pattern data, 

shift and ^ sin^tane^^can be ^J^^te The source and destination presentation spaces may or 

various coinbiiiaoons of keyboard input niust be taken into ^^6X000*1 with a remote window. The action that 

account when translating user input Once the traiisbhonis qJ^w ) ^ 6epcods on ^ ^ following descrip- 

completed by the "Wg"*™^ the conc^Mg [ PM ^ZmJrizss trTfo^cenarios possible, 

commands are sent to the PM interface 11 and provided to so , , . . 

the application 3 as input (step 2#). Subsequent to step 20, d) * both source and derfiiiauon F^entahon spaces are 

tie method proceedsT step 26 which detenninestf the local, then Witting takes place on the local PM machine m 

application program has ended. If so, the window is closed wc standard way. 

at step 21 and the process ends. However, if the program has (2) If the destination presentation space is a remote 

not ended, then the method returns to step 4, and the process 55 window and the source presentation space is associated with 

(subsequent to the creation of the window) is repeated. a bitmap that is server-potential and is current (up-to-date on 

The main function of the mapping means 5 is to redirect the server), men blitting is handled by die : server. No 

calls to the PM interface (specifically, to the PM WIN and transportation of the bitmap to the server need take place. If 

Gtri APIs) to the X lib. As described above, some of the the resident bitmap is not current, then the bitmap is updated 

translation is fairly straightforward If an X lib call exists 60 to the server again, marked as current, and then copied (at 

that corresponds to a PM call, then some simple parameter the server) to the destination window, 

shuffling may be all that is required- However, as noted (3) If the destination presentation space is a remote 

above, for complex graphical functions the mapping means window and no server-potential bitmap (or no bitmap at all) 

will have to break down the function and emulate it with has been selected into the source presentation space, then 

multiple calls to the X lib (eg. spline subroutine). Other PM 63 blitting is performed by copying the bitmap directly to the 

calls require the establishment of data structures to hold remote window. No storage of the bitmap is performed on 

local context or provide a mapping from a PM structure to the server. 
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(4) If both the source and destination presentation spaces GpQueryBitmapDimcnsion 

are remote windows, then blitring takes place on the server This function returns bitmap dimension 4aft » that has been 

directly- previously set with the GpiSetBitmapDimcDsion( ) function. 

Background patterning takes place when certain raster Bitmap dimension data is not related to the actual size of the 

operations arc specified. This is taken care of on the server 5 bitmap, and in fact, is not utilized by the system at all. 

end by setting up a "stipple" of the appropriate background ™ S fimction ^ work wWl ° ut modificalioD "> a remote 

pattern into the graphic context used during the blitring env^riment 

operation. If the pattern is one of the standard PM patterns, M ^ K At *u ♦ • 

then a stipple matching the pattern is created on the served £f Wtjr^ ^ 

mefirst^reo^ to ™^£^ C 10 * at *** bcen With GptfctBitmapfcK ) 

affects future drawing by being selected into a GC used in It wili work without modification in a remote environ- 

a drawing command. ment 

GpiWCBitBlt This function operates just as GpiBitBlt( ) GpiQueryBitro^pParameters 

does with these differences; This fiinction returns bitmap size data from a bitmap 

The source is always a bitmap, and not a presentation 15 nan< tt c - 

space. This means that the source always behaves like K ^ worlc wimout modification in a remote environ- 

a memory presentation space with a bitmap associated me ?l: _ . ^, 

with it C^iQueryDeviccBitmapFonriats 

. ^ - 4 ^ .... This function returns infonnation about supported bitmap 

The destination presentotioD space rectangle is given in M formats for the device associated with the passed presemi 

world coordinates rather than device coordinates. This tion space. 

means that the current transformation matrix applies. This function must be hooked so that only device bitmap 

This call may be used with retained drawing and formats that are supported by the remote display are 

metafiles, as well as immediate drawing. returned. 

Aside from these differences, this function follows the 25 GpiSetBitmap 

same rules as GpiBitBlt( ). This function associates a bitmap with a presentation 

GpiDrawBits s P acc - presentation space must be associated with a 

This function is similar to GpiWCBitBlt( ) and calls it to m ?f?? ry ' devkc conte * t ' 

perform its core function. The following comprise the cHf- ■ function te hooked so the bitmap handle is 

ferences between the two: 30 JJ 0 ^ 4 .^ DP ? CC 

lastcad of a source bitmap, the caller specifies image data aL. 1 ^? . t . , 

by supplying pomterT This function modifies a bitmap associated with a pre 

' , l~r c . . M sentation space. 

oireciiy to mrmap information and image data. It will work without modification in a remote environ* 

In all other respects, this function acts the same as ment 

GpiWCBitBlt( ). 35 GpiSetBitmapDimension 

GpOreateBitmap This function sets bitmap dimension data (not related to 

Tms function creates a bitmap that is logically associated the actual size of a bitmap, and not utilized by the system at 
with a particular device. The device is the one associated all) that may later be queried with the 
with the presentation space passed in the calL If this device GpiQueryBitmapDimension( ) function, 
is a remote display, the bitmap is marked as server-potential* ft will work without modification in a remote environ- 
but not downloaded until its first use. mcnt 
GpiDeleteBitmap GpiSetBitmapId 

This function deletes a bitmap created with one of the This function associates an ID value with a bitmap. Once 

bitmap creation functions. This function wfll cause the such an ID has been set, the bitmap may be queried by this 

bitmap to be removed from the server immediately, if it is ID. 

server-potential and has been downloaded at least once This function should work without modification in a 

a " ca< ty remote environment 

If the bitmap is a server-permanent bitmap, any call to WinDrawBirmap 
delete the bitmap executes normally as far as PM structures ^ This function is similar to GpiWCBitBlt( ) and uses it to 

are concerned But no deletion of the associated server perform its core function. The following comprise the dif- 

pixmapis done. ferences between these two functions: 

Gpi^dBitmap Destination rectangle is specified in device coordinates, 

, aCtsjUSt ^ G P iCreateBitma P( >■ * c rather than world cooimnates. 

following differences; «? 

t . j * _ • • ^ , 35 Foreground color, background color, color inversion, and 

Instead of obtaining the bitmap image from user supplied simple half-toning, but no other special operation, may 

data, the bitmap image is loaded from a resource. be performed by specifying arguments directly to this 

In all other aspects, this function is the same as calL 

GpiOeateBitmarX ). Id all other aspects, this function behaves the same as 

This function should work unmodified in a remote 60 GpiWCBitBlt( ). 

environment, once it is sanitized. WinOetSysBitmap 

GpiQueryBitmapBits This function is similar to GpiLoadBitmap( ), with the 

This function retrieves bitmap data from a presentation following differences: 

space which must be associated with a bitmap. The system bitmap to be loaded is specified by a system 

Since even server-potential bitmaps are stored locally, this 65 wide ID. 

function operates correctly without modification in a remote The source of the bitmap is specified by naming the 

environment desktop window which it wfll be drawn on. This allows 
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multiple versions of a bitmap that arc each customized This function causes a bitmap or a portion of a bitmap to 

for ^particular type of display. be transferred to a remote window. Tins mayinvolve tee 

The bitrnTis maifaTas ^permanent; It will remain update (through the Bm^Transport( ) f™*oo) of *c 

i nc oiuuop u> » V*.. „ \. t MUeste >i bitmap onto the server followed by a server to server copy, 

oo the server even after ttie jpUcation that Actively, if the bitmap is not of a type that uses a 

it terminates. The downloading only occurs the first 5 mieruauveiy, u mc » " . "\ \ «r . 

toTSw^ap is requested server-rodent copy, it is drawn duectly to the wtndow. 

BitmapDestroy( ) 

nkw FtlNfTlONS CREATED Called by XGpiDelcteBitmap( ) This function unassod- 

NEW FUNCTIONS CREAliiD ^ ft w f m m ^ jf a server-resident 

NEW FUNCTION NAME DESCRIPTION 10 version of the bitmap exists, current or not, it will be 

removed from the server. 
BitmapCreate( ) Called by XGpiCreateBitmap< ) BitmapProccss( ) 

This function creates a new "virtual 1 * server pixmap that Called by XGpiWCBitBlt( ), XGpiBitBlt( ), 
corresponds to a bitmap that may POTENTIALLY be <tis- XGpiSetBitmap( ), WinDrawBitmap( ) t 
played. Once created, changes to the associated bitmap are 15 GpiDeleteBitmap( ), GptCreateBitmap( ) 
hatched" so that the currency of the server version can be This function performs special pre-processing on a 
tested. A pixmap is not physically transported to the server bitmap, if necessary, before sending it to the server. Pre- 
just because it is created. Only when the bitmap is drawn processing always involves translating me original PM 
onto a remote wmdow for me first tiire bitmap to another PM bitmap, which men replaces the 
If transported, the bitmap is copied unaltered; i.e. raster-op 20 original bitmap in further processing. Pre-processing con- 
requests affecting the appearance of the bitmap are not version will be applied if either expansion/contraction is 
utilized in the copy from the host to the server. This occurs required. In both cases, the appropriate conversions, since 
only when the bitmap is copied from the server-resident they cannot be applied at the server, are applied locally to 
pixmap to a server-resident window, except in two special create the replacement bitmap, 
cases discussed elsewhere. 25 

This function will be called by all PM hooked functions OTHER FUNCTIONS AFFECTED 

that introduce a new bitmap to the system if there is a piTKmnN NAME DESCRIPTION 

possibility that the bitmap may be displayed on a remote FUNCTION NAME DESOUFUUN 

window. It will ensure that the necessary data structures are GpiPush( ), GpiPojX ), GpiQueryAttrs( ), GpiSetAnrs( ) 
created for tracking that bitmap. 30 Two-color bitmaps can utilize the current foreground and 

BitrnapInvalidX ) . . background colors as meir color map. These operations 

v ^^ X S^r^^1 xr^StT^ ^Te current foreground and background color. 
XOpiSetBitmap( ), XGpiBitBlt( ), XGpiWCBitBlt< ) RGBtoXPixeH ) 

TOs operation causes the ^^f^^^^A _< This DPMX function is used to translate a bitmap RGB 
bitmap to be considered^ of date ^^°^ e ™ 35 map to X pixel values before transporting the bitmap to the 
version, if it exists. Any further action requiring the presence r 
of the bitmap on the server will invoke BitrnapTransport( ) ? A(W ^p S( ) 

to transport or re-transport the bitmap. ^> reference variable (XPS.pixmap) which is 

This will happen whenever any drawing primitive affects a ^J^?^^ 

remote presentation space that has a server-potential bitmap DATA^UCl UKt* ^ . . . . 

i-Z1a- The fundamental bitmap structure used to track the stale 

n-^^nLlL ^ of a bitmap and it's server version, is SERVERBITMAP. 

S£^>SUitBlt( ), XGpiWCBitBlt( ) 45 One of these is created in a Rocked linked list for each 

^^pe^oTwill fransport the bitmap to the server, bitmap mat may be potentially displayed on a remote 
V S^T^A connate traSmations along window The blocked link Us t ^*^«^ 
towage bitmap is men marked as current entries that arc in a standard linked list format, but are 

Color transf ormation involves creating a local conversion allocated in multiple count groups. 

map. Each PM bitmap color (there will be either Z 16, or so 

256) will be mapped to the an X pixel value using the siKUcruRBS 1HAT chanced 
RGBtoXPixel( ) function. The bitmap will always be pro- typodef struct _xps 
moled (or demoted) to the depth most natural for the server. { 

If the original bitmap has a depth greater than me maximum hps hps; /* real v*amxa <*» 

supportable depth on the server, color information wfll 55 ^^^^ /• window this hps is * if 

naturally be lost any */ 

BitmapFmdX ) ka$ JCoaidSys; /• coordinate system of 

Called by XGpiWCBitBlt( ) XOj^itBlt( h ^g^****^, ~ u^ for in* «rtrib«» 

XGpiSetBitmap( ), WinDrawBitmap( ), GpiDdeteBitmap( ^ Xtkk ., ' ^^ njrUnemwae8 

), GpiCreateBitmap( ) 60 oc gedur. e gc vaoA for ctunctcr 

This function will return the pointer to the local bitmap attribute* on X side v 
tracking structure associated with it The function oc /• gc used for maker 

BilmapCreate( ) must have been called for the bitmap £f^ roXa £^ gcuaed for patten 

beforehand, or NULL will be returned. attributes on X skk */ 

BitmapDraw( ) 65 CT gefinage; /• gc used for image 

Called by XGpiBitBlt( ), XGpiWCBitBlt( ), attribute on x side •/ 
XWinDrawBitmarX ), XGpiDrawBits( ) 
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-continued 



/* current x coordinate in me 
/* current y coordinate in the 



short x; 
hps •/ 

abort y; 
hps*/ 

LONG IGoomWidth; /* line width during 

GpiStrokePatfa •/ 

LONG DCPSFlags; /* DPMX flags to keep track of 

extra stuff */ 

/* Attribute mode and saved attributes we have to keep 
track of •/ 

BOOL bAttrSave; f* 0ag to save attributes in 

UFO stack */ 

int iPMATTRCm; /* count of attributes in 

attribute stack •/ 

PMATTR *pPMATTR; t+ pointer to top of UFO 
attribute stack ♦/ 

/* Character values we have to keep track of */ 

LONG fcidCbar; /• current lcid for font ha V 

int jCharSets: A* count of number of char 

sets •/ 

SETMAP *pCharMap; /* pointer to top of char set 



SHORT feSelection; /* 

bokKtalk/strikecnjt/uaderline flags */ 

USHOKT usPreciskm; /• 1 = default, 2 = better, 3 
= best«/ 

SEEP sizfxChar, /* value* for w/h of character 

box*/ 

POINTL ptlAngle; f* point used to aetonnine 

text angle •/ 

POINTL. pdShean /* defines how pushed over 

chars are •/ 

USHORT usDtrection; /* l->r, u->d, etc */ 
USHOKT uilextAUgn; /* undocwacnted */ 
FIXED fxfixtra; /* extra spacing mcremeot for 

ail chare */ 

FIXED DtBreakBxtra; f* extra spacing increment far 

break char 1 

?* Marker values we have to keep track of */ 

int iMarkerSets; /* count of cumber of masker 

sets 4 / 

SETMAP *pMarkerMap; /* pointer to top of marker 
sot map array */ 

USHOKT usMarker; /• current marker symbol in 

marker set */ 

SEZEF eiz&Markcr, /* values for w/h of marker 

box f 

f* Marker values we have to keep track of */ 

int iPatSets; I* cowl of number of pattern 

sets */ 

SETMAP *pPatMap; /* pointer to top of pattern 

set map array */ 

int iPoadtknCnt; /* count of number of saved 

current positions •/ 

POINTL *pC\*"Pos; /* pointer to top of current 

position array */ 

/* Default values we have to keep track of ♦/ 

LZNEBUNDLB IbodTJefailt; 

CHARBUNDLE cbodDcfauh; 

MARKERBUNDLE mbndDefault; 

AREABUNDLE abndDefkuh; 

1MAGEBUNDLE ibodDefanlt; 

BOOL OoiorDocodclAxki; /♦ FALSE: Irxfexed off of 

current index; ♦/ 

/• TRUE: Direct RGB triplets 

•/ 

Pin i tap pixmap*, /* cunent pixmap, or 

KULL if not sot ♦/ 
fiief NOT_YET 

char cClipRects: f* count of the number of clipping 
rectangles; */ 

XRectangle *paxrClipRects^* pointer to array of 

clipping rectangles */ 

*cndif 

}XPS; 

NEW STRUCTURES 
struct SERVBRBTTMAP 
{ HBTTMAP LocaL; 
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-continued 



UCHAR 



Flags; 



•define SBlCVBSBriMAPFlAGctaTenl 0x01 // Bitmap is up 
5 to date on server 

♦define SBRVERBTTMAPFLAGperrnanent CMJ2 // Bitmap is to 
remain stored on 

//me i 

after fa wmnn ti^n 
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Although certain preferred embodiments have been 
shown and described, it should be understood that many 
changes and modifications can be made therein without 
departing from the scope of the appended claims. 
What is claimed is; 
15 1. A data processing system far displaying output of a 
program application executing on a first computer system, 
written for a first operating system on a second computer 
system having a second operating system; said second 
computer system connected to said first computer system, 
20 comprising: 

means for allocating a portion of said second computer 
display screen for the output of said program 
application, and a graphical user interlace on said 
second computer system, based on the second operat- 
25 ing system in said second computer system; 

means for enabling user commands to said graphical user 
Interface on said second computer system to be pro- 
cessed by said program application on said first com- 
puter system; and 
30 means for displaying the output from said program appli- 
cation and said graphical user interface in said portion 
of said display screen on said second computer system. 

2. A system according to claim 1 wherein said means for 
displaying comprises means for mapping commands from 

35 said program application on a first computer system to 
commands which can be interpreted by said second operat- 
ing system on said first computer system. 

3. A system according to claim 2 wherein said means for 
mapping comprises means for creating function in said 

^ second operating system on said second computer system to 
accommodate function present in said program application 
on said first computer system. 

4. A system according to claim 3 wherein said enabling 
means comprises: 

means for interpreting commands from said graphical 
user interface on said second computer system directed 
to said program application on said first computer 
system; and 

means for translating said commands into a form recog- 
50 nizable by said program application on said first com- 
puter system. 

5. A system according to claim 4 wherein said means for 
creating function comprises: 

means for comparing the program application function on 
55 said first computer system with function provided by 
said second operating system on said second computer 
system; 

means for determining the function within said second 
operating system on said second computer system 
60 related to said program application function on said 
first computer system; and 
means for using the function in said second operating 
system on said second computer system to simulate the 
application function on said first computer system. 
65 6. A method of displaying a program application, written 
for a first operating system and executing on a first computer 
system, comprising the steps of: 



45 
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allocating a portion of a computer display screen, for 
providing a graphical user interface based on a second 
operating system on a second computer system; 
enabling commands from said graphical user interface on 
said second computer system to be processed by said 
program application on said first computer system; and 
displaying output from said program application on said 
second computer system and said graphical user inter- 
face in said portion of said display screen on said 
second computer system. 

7. A method according to claim 6 wherein said step of 
displaying comprises the step of mapping commands from 
said program application on said first computer system to 
commands which can be interpreted by said second operat- 
ing system on said second computer system, 

8. A method according to claim 7 wherein said step of 
mapping comprises creating function in said second oper- 
ating system on said second computer system to accommo- 
date function present in said program application on said 
first computer system. 

9. A method according to claim 8 wherein said step of 
pnflhllng comprises the steps of: 

interpreting commands directed from second computer 
system to said program application on said first com- 
puter system; and 
translating said commands from said second computer 
system into a form recognizable by said program 
application on said first computer system. computer system, 

10. A method according to claim 9 wherein said step of 30 13. The method of 
creating function comprises the steps of: - *■ *— * 

comparing the program application function on said first 
computer system with function provided by said sec- 
ond operating system on said second computer system; « »» ~ r ~ 

determining the function within said second operating 35 system is Operating System/2 and said second operating 
system on said second computer system related to said system is ADC 
program application function on said first computer 

system; and * * * * 
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is 
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using the function in said second operating system on said 
first computer system to simulate the program applica- 
tion function on said first computer system 
U A method in a data processing system for displaying 
a remote application program in a window on a first com- 
puter system having a first graphical user interface from a 
first operating system, wherein said remote application 
program is in a second computer system having a second 
graphical user interface from a second operating system* 
said first computer system connected to said second com- 
puter system, comprising: 
starting the execution of said remote application program 
in said second computer system having said second 
graphical user interface from said first computer sys- 
tem; 

identifying said first computer system and a location for 
displaying said window by said second computer sys- 
tem; 

converting user input commands of said second graphical 
user interface into associated user input commands of 
said first graphical user interface; and 
displaying said remote application program and the asso- 
ciated user input commands of said first graphical user 
interface in said window on said first computer system. 
12. The method of claim 11 wherein the step of displaying 
said remote application program includes the step of map- 
ping the remote application text of said second computer 
system into associated remote application text of said first 



claim 11 wherein the step of displaying 
includes the step of controlling the remote application 
program on said second computer system by said associated 
user input commands on said second computer system ^ 
14. The method of claim 11 wherein said first operating 
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